Chuyển tới nội dung chính

Webhook Trạng Thái VA

API VA Flow

Đường dẫn​

  • URL: Partner cung cấp URL
  • Method: POST
  • Mô tả: Webhook này được kích hoạt khi có cập nhật trạng thái trên Virtual Account

Request​

Bảng Request​

Tham sốKiểu dữ liệu + Độ dàiBắt buộcMô tả
request_idstring(50)CóMã ID request duy nhất, định dạng đề xuất: MerchantCode+YYYYMMDDHHMMSS+UniqueId
request_timestring(19)CóThời gian request theo định dạng: YYYY-MM-DD HH:MM:SS
reference_codestring(100)CóMã tham chiếu của VA được quản lý trong hệ thống của bạn
statusstring(10)Có1: Hoạt động, 2: Không hoạt động
acc_nostring(22)CóSố tài khoản ngân hàng
reject_reasonstring(255)CóTrong trường hợp VA bị hủy kích hoạt, Baokim sẽ gửi lý do

Ví dụ Request​

{
"request_id": "PARTNER12320231105123000ID01",
"request_time": "2023-11-05 12:30",
"reference_code": "ORDER1234567890123456789012345",
"status": 1,
"acc_no": "12345678901234567890",
}

Response​

Bảng Response​

Tham sốKiểu dữ liệu + Độ dàiBắt buộcMô tả
response_codeint(4)CóMã lỗi từ Baokim theo Bảng Mã Lỗi
response_messagestring(100)CóMô tả mã lỗi từ Baokim theo Bảng Mã Lỗi

Ví dụ Response​

{
"response_code": 200,
"response_message": "Success"
}

Mã Lỗi​

Mã ResponseThông báo Response
200Success
11Failed
101System Error